home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / misc / emu / Over5_0_388.lha / Over5 / doc / Over5.doc < prev    next >
Text File  |  1995-08-09  |  7KB  |  263 lines
  1. Documentation for Over5 0.388 by Daniel Kahlin <tlr@stacken.kth.se>
  2. -----------------------------------------------------------------------------
  3.  
  4. Distribution:
  5.  
  6.   Over5 is FREEWARE (Freely-Distributable), but copyrighted by me. (NOT PD!) 
  7. None of the included files may be modified and/or removed.  Permission is
  8. given to freely distribute this program provided you include all files from
  9. the original archive, and no fee is charged in excess of reasonable media
  10. and mailing costs.  The program may not be used for commercial purposes
  11. without written permission from the author.
  12.  
  13.  
  14. Disclaimer:
  15.  
  16.   I cannot in any way be held responsible for anything this program does.
  17. You are using it entirely at your own risk.  Every effort has been made to
  18. keep this program bug free.  But, IF for example a bug exists that blows up
  19. your entire computer, don't blame me.
  20.  
  21. -----------------------------------------------------------------------------
  22.  
  23. GENERAL:
  24.  
  25.   Over5 (the successor to OverFour) is an AMIGA to/from C64 transfer program
  26. package.  It was made because of too many burnt 6526's and 8520's.  To overcome
  27. that problem I chose to use a standard RS-232 interface.
  28. Over5 contains several commands: COPY, WRITEFILE, READFILE, WRITEMEM, READMEM,
  29. SYS, SIMPLEWRITE, SIMPLEREAD, BOOT, DIR, STATUS, COMMAND, TEST, SERVER, HELP.
  30.  
  31.  
  32.  
  33. Documentation:
  34.  
  35.  
  36. command COPY:
  37. -------------
  38.  
  39. TEMPLATE: Over5 COPY FROM/M,TO/A,DEBUG/S
  40.  
  41.   FROM/M    source file/files 
  42.   TO/A      destination file/path
  43.   DEBUG/S   sets debug mode (shows all packets).
  44.  
  45. copies source to destination (like AmigaDOS copy) but '8:' is the 1541.
  46. The wildcard '*' can be used. (no wildcards on amigafiles, SORRY!)
  47.  
  48. example: copy 8:disksl* ram:
  49.  
  50.  
  51. command WRITEFILE:
  52. ------------------
  53. (this is a low level command, generally you should use 'COPY' instead)
  54.  
  55. TEMPLATE: Over5 WRITEFILE FROM/A,TO/A,DEBUG/S
  56.  
  57.   FROM/A    source file 
  58.   TO/A      destination file
  59.   DEBUG/S   sets debug mode (shows all packets).
  60.  
  61. copies source file from the amiga to the destination file on the 1541.
  62.  
  63.  
  64. command READFILE:
  65. -----------------
  66. (this is a low level command, generally you should use 'COPY' instead)
  67.  
  68. TEMPLATE: Over5 READFILE FROM/A,TO/A,DEBUG/S
  69.  
  70.   FROM/A    source file 
  71.   TO/A      destination file
  72.   DEBUG/S   sets debug mode (shows all packets).
  73.  
  74. copies source file from the 1541 to the destination file on the amiga.
  75.  
  76.  
  77. command WRITEMEM:
  78. ------------------
  79.  
  80. TEMPLATE: Over5 WRITEMEM FROM/A,RUN/S,RESET/S,DEBUG/S
  81.  
  82.   FROM/A    source file 
  83.   RUN/S     execute file with 'RUN' after transfer.
  84.   RESET/S   do reset on the c64 before transfer (with special hardware)
  85.   DEBUG/S   sets debug mode (shows all packets).
  86.  
  87. Writes source file into the c64 memory.
  88.  
  89.  
  90. command READMEM:
  91. ----------------
  92.  
  93. TEMPLATE: Over5 READMEM START/A,END/A,TO/A,RESET/S,DEBUG/S
  94.  
  95.   START/A   start address
  96.   END/A     end address
  97.   TO/A      destination file 
  98.   RESET/S   do reset on the c64 before transfer (with special hardware)
  99.   DEBUG/S   sets debug mode (shows all packets).
  100.  
  101. Reads c64 memory between START and END to the destination file.
  102.  
  103.  
  104. command SYS:
  105. ------------
  106.  
  107. TEMPLATE: Over5 SYS PC/A,MEMORY,SR,AC,XR,YR,SP,RESET/S,DEBUG/S
  108.  
  109.   PC/A      programcounter
  110.   MEMORY    contents of $01  (default 0x37)
  111.   SR        status register  (default 0x00)
  112.   AC        Accumulator      (default 0x00)
  113.   XR        X index register (default 0x00)
  114.   YR        Y index register (default 0x00)
  115.   SP        Stack pointer    (default 0xff)
  116.   RESET/S   do reset on the c64 before sys (with special hardware)
  117.   DEBUG/S   sets debug mode (shows all packets).
  118.  
  119. Starts code beginning at pc.
  120.  
  121.  
  122. command SIMPLEWRITE:
  123. --------------------
  124.  
  125. TEMPLATE: Over5 SIMPLEWRITE FROM/A,OLD/S
  126.  
  127.   FROM/A    source file 
  128.   OLD/S     obsolete protocol. use for FastRS 1.1 or earlier
  129.  
  130. Writes source file into the c64 memory using the simpleprotocol.
  131. (no handshaking)
  132.  
  133.  
  134. command SIMPLEREAD:
  135. -------------------
  136.  
  137. TEMPLATE: Over5 SIMPLEREAD TO/A,OLD/S
  138.  
  139.   TO/A      destination file 
  140.   OLD/S     obsolete protocol. Use this for FastRS 1.1 or earlier.
  141.  
  142. Reads source file from the c64 memory using the simpleprotocol.
  143. (no handshaking)
  144.  
  145.  
  146. command BOOT:
  147. -------------
  148. (this is only used to transfer 'DiskSlave' or similar for the first time)
  149.  
  150. TEMPLATE: Over5 BOOT FROM/A
  151.  
  152.   FROM/A    source file 
  153.  
  154. First it relocates the source file to $c000-len and appends 'copytail',
  155. then it sends the file at 150 baud to the c64. (no handshaking)
  156. Works together with the basic program 'boot.asc'.
  157. When transferred, just type 'SYS 49152<CR>' and save to DISK or TAPE.
  158.  
  159.  
  160. command DIR:
  161. ------------
  162.  
  163. TEMPLATE: Over5 DIR DEBUG/S
  164.  
  165.   DEBUG/S   sets debug mode (shows all packets).
  166.  
  167. Reads directory from the 1541 and shows it.
  168.  
  169.  
  170. command STATUS:
  171. ---------------
  172.  
  173. TEMPLATE: Over5 STATUS DEBUG/S
  174.  
  175.   DEBUG/S   sets debug mode (shows all packets).
  176.  
  177. Gets diskstatus from 1541 and shows it.
  178.  
  179.  
  180. command COMMAND:
  181. ----------------
  182.  
  183. TEMPLATE: Over5 COMMAND COMMAND/A,DEBUG/S
  184.  
  185.   COMMAND/A diskcommand
  186.   DEBUG/S   sets debug mode (shows all packets).
  187.  
  188. Sends a diskcommand to the 1541.
  189.  
  190.  
  191. command TEST:
  192. -------------
  193. (this command is not necessary for the ordinary user)
  194.  
  195. TEMPLATE: Over5 TEST BLOCK/S,FILE/S,DEBUG/S
  196.  
  197.   BLOCK/S   test block transfer
  198.   FILE/S    test file transfer
  199.   DEBUG/S   sets debug mode (shows all packets).
  200.  
  201. Tests block transfer and/or file transfer.
  202.  
  203.  
  204. command SERVER:
  205. ---------------
  206.  
  207. TEMPLATE: Over5 SERVER DEBUG/S
  208.  
  209.   DEBUG/S   sets debug mode (shows all packets).
  210.  
  211. Sets the amiga in SERVER MODE.  Run 'SerFile' on the c64 to use it.
  212.  
  213. commands (#C"<COMMAND>" in 'SerFile')
  214.  
  215. #C"DIR" or #C"$" or #$
  216.   Displays the files in the current directory.
  217.  
  218. #C"CD"
  219.   Displays the name of the current directory.
  220.  
  221. #C"CD <dir>"
  222.   Set the current directory to <dir>.
  223.  
  224.  
  225.  
  226.  
  227.  
  228. command HELP:
  229. -------------
  230.  
  231. TEMPLATE: Over5 HELP or Over5 ?
  232.  
  233. Shows small help text.
  234.  
  235.  
  236.  
  237. System requirements:
  238.  
  239.   Over5 should run on any system setup running OS2.04 or higher, although it
  240. has only been tested on an A3000/25 running OS3.1.  If you find bugs or have
  241. suggestions about how to make the program better please send a bugreport or
  242. a list of suggestions to the address at the end of this text.
  243.  
  244. -----------------------------------------------------------------------------
  245.  
  246. Author:
  247.  
  248.   Daniel Kahlin is a student at the Royal Institute of Technology (Stockholm)
  249. Former c64 demo programmer (1986-1988).  He is deeply involved with computers
  250. and electronics.
  251.  
  252.    InterNet:  <tlr@stacken.kth.se>
  253.  
  254.   SnailMail:  Daniel Kahlin
  255.               Vanadisvägen 6, 2tr
  256.               s-113 46 Stockholm
  257.               Sweden
  258.  
  259.       Phone:  08-34 84 73 (+468348473)
  260.  
  261. -----------------------------------------------------------------------------
  262.  
  263.